home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Source Code / Visual Basic Source Code.iso / vbsource / optivc16 / readme.txt < prev    next >
Text File  |  1999-03-06  |  9KB  |  218 lines
  1.       ┌───────────────────────────────────────────────────────────────┐
  2.       │                                                               │
  3.       │                      OptiVec for C / C++                      │
  4.       │                   by Martin Sander 1996-1999                  │
  5.       │                                                               │
  6.       │                     Shareware Version 1.5                     │
  7.       └───────────────────────────────────────────────────────────────┘
  8.  
  9.  
  10. 1. Introduction
  11. ---------------
  12. Vector functions instead of loops - if it matters to you how fast and how
  13. accurate your data are processed!
  14. The largest portion of almost all programs processing numerical data
  15. consists of loops. Replace these loops by the specialized vector
  16. and matrix functions of OptiVec, and exploit all the advantages of
  17. vectorized programming:
  18.  
  19. - OptiVec was almost entirely written in Assembly language. The result is a
  20.   highly optimized and numerically accurate code, running 2-3 times faster
  21.   than compiled loops.
  22.  
  23. - fully vectorized forms of all operators and functions of the language
  24.   C/C++ for all integer and floating-point (including complex!) data types
  25.  
  26. - Additionally many other real and complex math functions, statistics,
  27.   analysis, FFT techniques, graphics - in total more than 3000!
  28.  
  29. - Simple and logical syntax, for example
  30.   "VF_exp( Y, X, size );"      for Y[i] = exp( X[i] ) with "float" arrays,
  31.   "VD_FFT( Y, X, size, 1 );"   for double-precision forward FFT
  32.   "ME_mulM( MZ, MX, MY, htX, lenX, lenY );"
  33.                                for extended-precision matrix multiplication
  34.  
  35. 2. System requirements
  36. ----------------------
  37. This version of OptiVec is designed for IBM AT, PS/2 or compatibles,
  38. equipped at least with a 80386 CPU and a 80387 coprocessor
  39. (Visual C++ version: at least 486DX).
  40. Depending on your choice when ordering or downloading,
  41. - either for Borland C++ (Turbo C++), version 3.0 or higher, memory
  42.   models Win32, Windows-LARGE, or  DOS-LARGE
  43. - or for Microsoft Visual C++, version 5.0 or higher, "single-thread debug"
  44.   or "multi-thread debug"
  45.  
  46. Registered version for Borland C/C++:
  47. all memory models; separate libraries optimized for all processors from
  48. 486DX/Pentium down to 286 with or without coprocessor.
  49.  
  50. Registered version for Microsoft Visual C++:
  51. all PC models using the "single-thread", "multi-thread", or
  52. "multi-thread DLL" run-time libraries, both for debug and release.
  53.  
  54. 3. Installation
  55. ---------------
  56. Please run the installation program INSTALL.EXE. If anything goes wrong,
  57. you may try the following:
  58.    a) Create the directory where you want OptiVec to reside.
  59.    b) Manually unzip the file DOC.ZIP into it.
  60.    c) Create a sub-directory /LIB and unzip the file LIB.ZIP into it.
  61.    d) Create a sub-directory /INCLUDE and unzip the file INCLUDE.ZIP into it.
  62. If you don't succeed that way, you probably got a corrupted download.
  63. Please download again. If even that does not help, please contact:
  64. MartinSander@Bigfoot.com.
  65.  
  66. After you completed the installation, you must set the library search path
  67. and the include-file search path according to your OptiVec directory choice:
  68. Add these paths to the standard settings in the menu
  69. "Options/Project/Directories" of Borland C 4.x, 5.x, and BC++ Builer, or
  70. "Options/Directories" in Borland C++ 3.x.
  71. (Remember: a semicolon is used to separate entries in these fields.)
  72.  
  73.  
  74. 4. Running the examples
  75. -----------------------
  76.  
  77. Check your installation by compiling and running the appropriate demo file.
  78. Follow the instructions in the header of that file.
  79. If you get compiler errors like "Cannot open include file ...", or a
  80. linker error "Unresolved external", you probably did not set the library
  81. and include paths correctly.
  82.  
  83. OptiVec for Borland C/C++:
  84.   VDEMO.CPP   is a DOS program,
  85.   VDEMOW.CPP  is for Windows with Borland C++ 5.0 or higher.
  86.   Separate versions of the Windows demo program are supplied for
  87.   older BC versions:
  88.   VDEMOW1.CPP is for Borland C++ 3.x with OWL 1.0
  89.   VDEMOW2.CPP is for Borland C++ 4.0 with OWL 2.0
  90.  
  91.  
  92.   For DOS, create a project containing
  93.      VDEMO.CPP,  VCL3.LIB, and  GRAPHICS.LIB.
  94.      Choose the application either as DOS Standard or as DOS Overlay.
  95.      VCL3.LIB may or may not be used as an overlay (option to be set:
  96.      "Project/Local Options/Overlay this module").
  97.      Choose the memory  model LARGE.
  98.      Check the floating-point options. Neither "No floating-point" nor
  99.      "Floating-point emulation" should be selected.
  100.  
  101.   For 16-bit Windows with Borland C++ 3.x and OWL 1.0
  102.       create a project containing
  103.       VDEMOW1.CPP,  VCL3W.LIB, and OWL.DEF.
  104.       Choose the application as Windows-EXE, model LARGE.
  105.       Choose the memory model LARGE and 287 floating-point operations
  106.  
  107.   For 16-bit Windows with Borland C++ 4.x and OWL 2.0
  108.       create a project containing
  109.       VDEMOW2.CPP and VCL3W.LIB.
  110.       In the TargetExpert, choose as target
  111.         Application [.EXE]  for Windows 3.x, model LARGE.
  112.         Tick the boxes for Standard Libraries OWL, ClassLibrary, and Runtime.
  113.         Use, as you prefer, either Dynamic or Static linking.
  114.  
  115.   For Windows95, 98 or NT with Borland C++ 4.x and OWL 2.0
  116.       create a project containing
  117.       VDEMOW2.CPP and VCF3W.LIB.
  118.       In the TargetExpert, choose as target
  119.         Application [.EXE]  for Win32, GUI model.
  120.         Tick the boxes for Standard Libraries OWL, ClassLibrary, and Runtime.
  121.         Use Static linking and Single-Thread (which means: don't check the
  122.         Multithread box).
  123.  
  124.   For 16-bit Windows with Borland C++ 4.x, 5.x or higher (without OWL)
  125.       create a project containing
  126.       VDEMOW.CPP and VCL3W.LIB.
  127.       In the TargetExpert, choose as target
  128.         Application [.EXE]  for Windows 3.x, model LARGE.
  129.         Tick the boxes for Standard Libraries ClassLibrary, and Runtime.
  130.         Use, as you prefer, either Dynamic or Static linking.
  131.  
  132.   For Windows95, 98 or NT with Borland C++ 4.x, 5.x or higher (without OWL)
  133.       create a project containing
  134.       VDEMOW.CPP and VCF3W.LIB.
  135.       In the TargetExpert, choose as target
  136.         Application [.EXE]  for Win32, GUI model.
  137.         Tick the boxes for Standard Libraries ClassLibrary, and Runtime.
  138.         Use Static linking and Single-Thread
  139.  
  140.  
  141. OptiVec for Microsoft Visual C++:
  142.     create a project as a "Win32 application", containing
  143.     VDEMOW.CPP  and  OVVCSD.LIB.
  144.     Choose single-thread debug.
  145.  
  146. Data-fitting functions demo:
  147.     There is a demo file for the data-fitting functions, FITDEMO.CPP.
  148.     You can use it with Borland C++ (4.x or higher) or Visual C++,
  149.     under Windows 3.1 or Windows 95/98/NT.
  150.     Follow the instructions given above for VDEMOW.CPP, replacing
  151.     VDEMOW.CPP by FITDEMO.CPP.
  152.     With 16-bit BC++, you must additionally include the library MCL3W.LIB.
  153.  
  154.  
  155. 5. Documentation
  156. ----------------
  157. The full OptiVec documentation is to be found in the files
  158. HANDBOOK.TXT, FUNCREF.TXT, MATRIX.TXT, and CMATH.TXT as ASCII text.
  159. If you want to load the documentation into a word processor under Windows,
  160. you must use the filter "ASCII text" or "DOS text".
  161.  
  162.  
  163. 6. Copyright
  164. ------------
  165. The copyright owner of this product as a whole and of all its constituent
  166. parts is
  167.          Dr. Martin Sander Software Development
  168.          Serturnerstr. 11
  169.          D-37085 Goettingen
  170.          Germany
  171.          e-mail: MartinSander@Bigfoot.com
  172.  
  173. This Shareware version of OptiVec is freely distributable in unchanged form.
  174. For the distribution of applications created using OptiVec, you need the
  175. registered version. The detailed licence terms are described in chapter 1.2
  176. of the file HANDBOOK.TXT.
  177.  
  178.  
  179. 7. Registered Version
  180. ---------------------
  181. If you like OptiVec and decide to use it, please be fair and register.
  182. The registered version
  183.  
  184. -  supports all memory models of Windows95, NT, 3.x, and DOS of Borland C++,
  185.    or all PC debug and release targets of Visual C++, respectively.
  186.  
  187. -  has individually optimized libraries for each degree of processor
  188.    backward-compatibility (Borland C++ only):
  189.